package com.xiliubit.cloudpicture.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.xiliubit.cloudpicture.model.dto.space.SpaceAddRequest;
import com.xiliubit.cloudpicture.model.dto.space.SpaceQueryRequest;
import com.xiliubit.cloudpicture.model.entity.Space;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiliubit.cloudpicture.model.entity.User;
import com.xiliubit.cloudpicture.model.vo.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
* @author 86173
* @description 针对表【space(空间)】的数据库操作Service
* @createDate 2025-08-08 14:17:41
*/
public interface SpaceService extends IService<Space> {
    /**
     * 转换空间至Vo对象
     * @param space 空间
     * @param request  请求
     * @return 空间Vo信息
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 获取查询包装类
     * @param spaceQueryRequest 查询条件
     * @return 查询条件
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 获取分页查询结果进行VO转换
     * @param page 分页信息
     * @param request 请求
     * @return 空间Vo信息
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> page, HttpServletRequest request);

    /**
     * 校验空间信息
     * @param space 空间信息
     * @param add  是否为创建
     */
    void validSpace(Space space, boolean add);

    /**
     * 填充空间参数
     * @param space 空间信息
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 添加空间
     * @param spaceAddRequest 添加空间请求
     * @param loginUser 登录用户
     * @return 添加的空间id
     */
    long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);

    /**
     * 检查空间权限
     * @param loginUser 登录用户
     * @param space 空间
     */
    void checkSpaceAuth(User loginUser, Space space);
}
